home *** CD-ROM | disk | FTP | other *** search
/ PC Media 4 / PC MEDIA CD04.iso / share / udos / sst_53a / sst.doc < prev    next >
Text File  |  1991-07-01  |  49KB  |  1,144 lines

  1.  
  2.  
  3.  
  4.  
  5.                    SST: the Supersonic Search Tool  v5.3a
  6.  
  7.                             Released July 2, 1991
  8.  
  9.                      A PC-DOS / MS-DOS Fast File Finder
  10.  
  11.  
  12.  
  13.                               _______
  14.                          ____|__     |               (tm)
  15.                       --|       |    |-------------------
  16.                         |   ____|__  |  Association of
  17.                         |  |       |_|  Shareware
  18.                         |__|   o   |    Professionals
  19.                       -----|   |   |---------------------
  20.                            |___|___|    MEMBER
  21.  
  22.  
  23.  
  24.  
  25.                          Written by Keith Ledbetter
  26.                                     4240 Ketcham Drive
  27.                                     Chesterfield, VA  23832
  28.                                     (804) 674-0780
  29.                                     (6:00pm - 10:00pm Eastern Time)
  30.  
  31.                 Tech Support BBS:   Blue Ridge Express
  32.                                     804-790-1675
  33.                                     30 Phone Lines (2400 bd)
  34.                                     Sub-board KEITHL
  35.                                     ("J KEITHL")
  36.  
  37.           Electronic mail on GEnie: ORION.MICRO
  38.                         CompuServe: 72240,1221
  39.                                BIX: kledbetter
  40.  
  41.  
  42.   Program and Documentation are Copyright (c) 1988-1991 by Keith Ledbetter.
  43.                                All rights reserved.
  44.  
  45.  
  46.   Portions Copyright Borland, International.  SST is written in Borland C++.
  47.  
  48.  
  49.     This program is produced by a member of the Association of Shareware
  50. Professionals (ASP).  ASP wants to make sure that the shareware principle
  51. works for you. If you are unable to resolve a shareware-related problem with
  52. an ASP member by contacting the member directly, ASP may be able to help. The
  53. ASP Ombudsman can help you resolve a dispute or problem with an ASP member,
  54. but does not provide technical support for members' products. Please write to
  55. the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a Compuserve
  56. message via easyplex to ASP Ombudsman 70007,3536.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.    SST Registration Form         Keith Ledbetter
  65.                                  4240 Ketcham Drive
  66.                                  Chesterfield, VA  23832
  67.  
  68.  
  69.    SST Version 5.3a                           Quantity    Price
  70.  
  71.    Disk with branding utility ($15/copy):      _______   __________
  72.  
  73.         Total enclosed                                   __________
  74.  
  75.    Please make payment by check or money order (in US funds) payable
  76.    to "Keith Ledbetter".
  77.  
  78.    Please specify the diskette size(s) that are acceptable for you:
  79.  
  80.    ___ 5.25" 1.2MB   ___ 3.5" 1.44MB   ___ 5.25" 360KB   ___ 3.50" 720KB
  81.  
  82.  
  83.    Name    ________________________________________________________
  84.  
  85.    Company ________________________________________________________
  86.  
  87.    Address ________________________________________________________
  88.  
  89.            ________________________________________________________
  90.  
  91.    Phone   ________________________________________________________
  92.  
  93.  
  94.    Where did you get SST?      ____________________________________
  95.  
  96.    Multi-System and Reseller Licenses:
  97.  
  98.         Site, corporate, network, and reseller licenses are available
  99.         for SST.  Check the line on the order form or contact me for
  100.         more information.  The following schedule provides some
  101.         examples of multi-system license fees.  The fee includes one
  102.         master diskette which you may then copy and use on the number
  103.         of machines listed below:
  104.  
  105.                         # Users        Price
  106.                         -------       -------
  107.                            5        $   70.00   ($14 / copy)
  108.                           10           130.00   ($13 / copy)
  109.                           25           300.00   ($12 / copy)
  110.                           50           550.00   ($11 / copy)
  111.                          100         1,000.00   ($10 / copy)
  112.                        Unlimited     1,500.00
  113.  
  114.                              Supersonic Search Tool                   Page 1
  115.  
  116.  
  117.                             Definition of ShareWare                           
  118.  
  119.  
  120.  
  121.     Shareware distribution gives users a chance to try software before
  122.     buying it.  If you try a Shareware program and continue using it,
  123.     you are expected to register. Individual programs differ on details
  124.     -- some request registration while others require it, some specify
  125.     a maximum trial period. With registration, you get anything from the
  126.     simple right to continue using the software to an updated program with
  127.     printed manual.
  128.  
  129.     Copyright laws apply to both Shareware and commercial software,
  130.     and the copyright holder retains all rights, with a few specific
  131.     exceptions as stated below. Shareware authors are accomplished
  132.     programmers, just like commercial authors, and the programs are
  133.     of comparable quality. (In both cases, there are good programs
  134.     and bad ones!) The main difference is in the method of
  135.     distribution. The author specifically grants the right to copy
  136.     and distribute the software, either to all and sundry or to a
  137.     specific group. For example, some authors require written
  138.     permission before a commercial disk vendor may copy their
  139.     Shareware.
  140.  
  141.     Shareware is a distribution method, not a type of software. You
  142.     should find software that suits your needs and pocketbook,
  143.     whether it's commercial or Shareware. The Shareware system makes
  144.     fitting your needs easier, because you can try before you buy.
  145.     And because the overhead is low, prices are low also. Shareware
  146.     has the ultimate money-back guarantee -- if you don't use the
  147.     product, you don't pay for it.
  148.  
  149.                              Supersonic Search Tool                   Page 2
  150.  
  151.  
  152.                              Disclaimer - Agreement                           
  153.  
  154.  
  155.  
  156.     Users of SST must accept this disclaimer of warranty:
  157.     "SST is supplied as is.  The author disclaims all
  158.     warranties, expressed or implied, including, without limitation,
  159.     the warranties of merchantability and of fitness for any purpose.
  160.     The author assumes no liability for damages, direct or conse-
  161.     quential, which may result from the use of SST."
  162.  
  163.     SST is a "shareware program" and is provided at no charge
  164.     to the user for evaluation.  Feel free to share it with your
  165.     friends, but please do not give it away altered or as part of
  166.     another system.  The essence of "user-supported" software is to
  167.     provide personal computer users with quality software without
  168.     high prices, and yet to provide incentive for programmers to
  169.     continue to develop new products.  If you find this program
  170.     useful and find that you are using SST and continue to use
  171.     SST after a reasonable trial period, you must make a reg-
  172.     istration payment of $15 to Keith Ledbetter.  The $15
  173.     registration fee will license one copy for use on any one
  174.     computer at any one time.  You must treat this software just like
  175.     a book.  An example is that this software may be used by any
  176.     number of people and may be freely moved from one computer
  177.     location to another, so long as there is no possibility of it
  178.     being used at one location while it's being used at another.
  179.     Just as a book cannot be read by two different persons at the
  180.     same time.
  181.  
  182.     Commercial users of SST must register and pay for their
  183.     copies of SST within 30 days of first use or their license
  184.     is withdrawn.  Site-License arrangements may be made by con-
  185.     tacting Keith Ledbetter.
  186.  
  187.     You are encouraged to pass a copy of SST along to your
  188.     friends for evaluation.  One easy way to do this is by placing
  189.     SST on your favorite Bulletin Board System.  Please encourage
  190.     users to register their copy if they find that they can use it.
  191.     All registered users will receive a copy of the latest version
  192.     of the SST program.
  193.  
  194.                              Supersonic Search Tool                   Page 3
  195.  
  196.  
  197.                                   Introduction                                
  198.  
  199.  
  200.  
  201. Note:  For a list of new features in this version, see the file HISTORY.DOC.
  202.  
  203.  
  204.    Thank you for taking the time to try out SST v5.3a.  You will find
  205. that SST can satisfy almost all of your file searching needs.  It has
  206. a multitude of search options, some of which are:
  207.  
  208.             o   The ability to search inside ARC, ZIP, PKA, PAK,
  209.                 ZOO, ARJ, and LZH archived files.
  210.  
  211.             o   The ability to search for files that have been
  212.                 compressed with PK-Ware's PKLite program.
  213.  
  214.             o   True regular expression searching on filenames.
  215.  
  216.             o   The ability to display duplicate entries across all of
  217.                 your disk drives (even those duplicates that are in the
  218.                 archive files mentioned above!).
  219.  
  220.             o   Up to 25 filenames can be excluded from the search.
  221.  
  222.             o   Built-in ZIP archive error detection.  Every time you
  223.                 do a search that includes ZIP files, every ZIP file on
  224.                 your hard drive is checked for integrity!
  225.  
  226.             o   The ability to do restrictive searches on such criteria
  227.                 as file dates and file sizes.
  228.  
  229.             o   The ability to do a verified (or un-verified) deletion
  230.                 of any files found in the search (great for periodically
  231.                 deleting those .BAK files or files with a size of zero).
  232.  
  233.             o   Support for Novell's "volume" configurations.
  234.  
  235.             o   Default switches can be set in an environment variable.
  236.  
  237.  
  238.    Don't be fooled by imitations.  There are recent file finder programs out
  239. there making claims that their "features" are "never before found in any
  240. file finder programs".   Funny!  Their "features" (like date-range searching
  241. and filesize searching) have been in our program a YEAR before they were
  242. even released!
  243.  
  244.  
  245.    Now, here is the only pitch that you'll see in this document for some of
  246. your hard-earned money.   SST is being distributed as a Shareware product.
  247. If you find that you are still using this program a couple of weeks after
  248. you get it, please take the time to fill out the registration form at the
  249. front of this documentation file and send in your registration fee of $15.
  250.  
  251.  
  252.  
  253.                              Supersonic Search Tool                   Page 4
  254.  
  255.  
  256.                                   Introduction                                
  257.  
  258.  
  259.    When you send in your registration fee, you will receive a disk with the
  260. most recent version of SST, along with a BRAND utility that you can use
  261. to place your name and serial number into ALL FUTURE VERSIONS of SST.
  262. No future upgrade costs; you pay only one time!   You will also receive
  263. unlimited telephone support for the program.   Registered SST users may
  264. call me at (804) 674-0780 between the hours of 6:00 pm - 10:00 pm (Eastern)
  265. Monday-Friday, and from 10 am - 6 pm on the weekends.   Thank you for
  266. supporting SST and my other Shareware programs!
  267.  
  268.  
  269.                              Supersonic Search Tool                   Page 5
  270.  
  271.  
  272.                                  What SST Does                                
  273.  
  274.  
  275.  
  276.   SST helps hard drive owners retain (some of) their sanity by locating
  277. files on their hard drives.   We've all had situations where we KNOW that a
  278. file is somewhere on the hard drive; we just can't remember where.  Another
  279. added feature of SST is that it can be told to look inside of archive files,
  280. too.  This is a very important feature with the common acceptance of archived
  281. files these days.  In this document, "archive files" is used as a generic
  282. term for any file with the following extension:
  283.  
  284.             .ARC    .ARJ    .ZIP    .LZH    .ZOO    .PAK    .PKA
  285.  
  286.   Other advanced features of SST include (a) grep-type searching on
  287. filenames (eg: find filenames with a '4' in the fifth character), (b) date
  288. and time range specifiers, and (c) file size range specifiers.  There are
  289. many switches for SST, and it is highly recommended that you read this
  290. document carefully so that you will be able to get the most out of the
  291. program.  There are very few things you can't do with SST when it comes
  292. to locating files.   As an advanced example:
  293.  
  294.  
  295.     SST cde:*.bak "[0-9]" -gt1024 -lt2048 -s12-10-89 -b12-20-89 -v
  296.  
  297.  
  298.    How about THAT for a command line?  What this would do is delete all .BAK
  299. files on drives C:, D:, and E: that have a number somewhere in the filename
  300. (eg: PROG01.BAK).  But, only if the file is between 1025 and 2047 bytes in
  301. length, and was last modified sometime between the dates of 12-10-89 and
  302. 12-19-89.
  303.  
  304.    Yes, I know that you'll probably never need to do something exotic as
  305. this, but it shows the power that you have with SST.  Take the time to
  306. learn SST, and it will always be your friend.
  307.  
  308.                              Supersonic Search Tool                   Page 6
  309.  
  310.  
  311.                            The Command Line Interface                         
  312.  
  313.  
  314.  
  315.   Invoking SST is simplicity itself.  If you do not specify a path,
  316. then SST will search the entire default drive.  If you specify a
  317. starting path, then the search will occur from that path downward (only).
  318.  
  319.   Here are some basic command line examples:
  320.  
  321.   SST ab*.c                     search entire default drive for any filename
  322.                                 matching "ab*.c".
  323.  
  324.   SST \turboc\ab*.c             search downward from the \turboc\ directory
  325.                                 on the default drive looking for "ab*.c".
  326.  
  327.   SST d:*.dat -a                search entire drive d: and all archive files
  328.                                 on drive d: looking for "*.dat".
  329.  
  330.   SST cd:*.dat -a               search entire drive c: and drive d: and all
  331.                                 archive files looking for "*.dat".
  332.  
  333.   SST myprog                    search entire default drive looking for
  334.                                 "myprog.*" (SST will append a ".*" to
  335.                                 a filename with no extension specified).
  336.  
  337.   SST myprog.                   search entire default drive looking for
  338.                                 "myprog".  If you specify a "." after a
  339.                                 filename, SST will not append an "*" to it.
  340.  
  341.  
  342.                              Supersonic Search Tool                   Page 7
  343.  
  344.  
  345.                              Command Line Switches                            
  346.  
  347.  
  348.  
  349.      Switch:  -A
  350.     Meaning:  search all archive files
  351. Description:  The '-a' switch tells SST to look in any archive file
  352.               encountered for a matching filename.  If a matching filename
  353.               is found, it will be displayed in parenthesis along with the
  354.               full name of the archive file it resides in.
  355.  
  356.  
  357.      Switch:  -AO
  358.     Meaning:  search -ONLY- archive files
  359. Description:  The '-ao' switch tells SST to ONLY look in any archive file
  360.               encountered for a matching filename.  If a matching filename
  361.               is found, it will be displayed in parenthesis along with the
  362.               full name of the archive file it resides in.
  363.  
  364.  
  365.      Switch:  -ARC -ARJ -PKA -LZH -ZIP -ZOO
  366.     Meaning:  search only the archive formats specified
  367. Description:  These switches tell SST to only look inside the specified
  368.               types of archive files for a matching filename.  For example,
  369.               if you are sure that the file named MYPROG.EXE is somewhere
  370.               on drive C: in a .ZIP file, then
  371.  
  372.                         SST c:myprog.exe -zip
  373.  
  374.               would find the file.  Specifying individual archive format
  375.               switches slightly speeds up SST, because the program doesn't
  376.               have to waste time searching for (and through) all six archive
  377.               formats.
  378.  
  379.  
  380.      Switch:  "regular expression"
  381.     Meaning:  do a grep-type search on the filename
  382. Description:  Any command line string enclosed within double quotes will be
  383.               considered a regular expression, and will cause SST to go
  384.               into its "grep mode".   A regular expression can be used with
  385.               or without a filename search mask.
  386.  
  387.               As of version 4.1a, when you specify a regular expression,
  388.               SST will also look inside of 4DOS description files for
  389.               the string specified.  If a match is found, the normal output
  390.               line will be displayed, along with the actual 4DOS description
  391.               line below the filename line.
  392.  
  393.               Special characters within the quoted string are as follows:
  394.  
  395.  
  396.                       ^  -  start matching at the first of the filename
  397.                       ?  -  match any character in this position
  398.                     [..] -  range check on character at this position
  399.  
  400.  
  401.                              Supersonic Search Tool                   Page 8
  402.  
  403.  
  404.                              Command Line Switches                            
  405.  
  406.  
  407.               The easiest way to explain is with a few examples:
  408.  
  409.               SST *.bat
  410.  
  411.                   the regular search; will display any .BAT file found.
  412.  
  413.  
  414.               SST *.bat "42"
  415.  
  416.                   will display any .BAT file that contains the characters
  417.                   "42" anywhere in the filename.
  418.  
  419.  
  420.               SST *.bat "^???42"
  421.  
  422.                   will display any .BAT file that contains the characters
  423.                   "42" in the fourth position of the filename.
  424.  
  425.  
  426.               SST "[0-9]"
  427.  
  428.                   will display any file that contains a number anywhere in
  429.                   the filename.
  430.  
  431.  
  432.               SST "[^0-9]"
  433.  
  434.                   will display any file that DOES NOT contain a number
  435.                   anywhere in the filename.
  436.  
  437.  
  438.               SST "^???a?[acew-z]"
  439.  
  440.                   will display any file that contains an 'a' in the fourth
  441.                   position of the filename and the letters 'a', 'c', 'e',
  442.                   'w', 'x', 'y', or 'z' in the sixth position of the name.
  443.  
  444.  
  445.               These grep masks also work when looking inside of archive files.
  446.  
  447.  
  448.       Switch:  -C"command to execute"
  449.                -CV"command to execute"
  450.                -O"command to display"
  451.      Meaning:  Execute (or display) a DOS command on all files found.
  452.  Description:  This switch tells SST to execute the command within the
  453.                double quotes on each matching file found.  When doing this
  454.                command, you have access to replaceable parameters to get to
  455.                the full filename, the pathname only, the filename only, and
  456.                the name of the archive member (if you're searching archives).
  457.                When you use the -cv switch, it operates identically to the
  458.                -c switch, except that SST will ask you for confirmation
  459.  
  460.                              Supersonic Search Tool                   Page 9
  461.  
  462.  
  463.                              Command Line Switches                            
  464.  
  465.  
  466.                before it actually executes the command.
  467.                The only difference between the -o and the -c switches is
  468.                that -c actually executes the command whereas -o prints the
  469.                command it WOULD have executed to the screen.  Because of
  470.                this, the -o command can be invaluable.  First, you can use
  471.                it before doing the -c command to make sure that what you
  472.                think you told SST to do is the same as what you DID
  473.                tell it to do.  In other words, if you're about to do a
  474.                command that could have side effects (such as deleting files),
  475.                it would be good to do the -o command first and look at what
  476.                SST actually will do when you execute the -c command.
  477.                The second use of the -o command is to redirect all of the
  478.                command lines into a batch file that you can execute later.
  479.                Replacement parameters for both -c and -o are as follows:
  480.  
  481.         Parm      Desc           Normal example      Archive example
  482.         ----      ----          -----------------   -----------------
  483.          &f   full file name    c:\dos\xcopy.exe    c:\dos\comlib.zip
  484.          &p   path name only    c:\dos\             c:\dos\
  485.          &d   directory name    c:\dos              c:\dos
  486.          &n   file name only    xcopy.exe           comlib.zip
  487.          &m   archive member    <blank>             xcopy.exe
  488.          &r   root of the name  xcopy               xcopy
  489.          &&   the '&' char
  490.  
  491.                A few examples would probably be the best way to explain this
  492.                concept.  Let's do a few "real-world" examples here.
  493.  
  494.                1)  You have many .DOC files straying all over your hard drive,
  495.                    and you'd like to incorporate them all into one simple
  496.                    ZIP file.  You could do this with the following command:
  497.  
  498.                       C:> SST -d *.doc -c"pkzip -m c:\docs.zip &f"
  499.  
  500.                2)  You want to make a copy of all of your Pascal source code
  501.                    that has been changed today so that you can take it home
  502.                    with you:
  503.  
  504.                       C:> SST -d *.pas -s0 -c"copy &f a:\"
  505.  
  506.                3)  You want to get a text file listing of every directory
  507.                    name on your hard drive(s) in the file HARDRIVE.DAT:
  508.  
  509.                       C:> SST -d nul -o"&p" >c:\Hardrive.Dat
  510.  
  511.                4)  You want to delete every .BAK file on your system (even
  512.                    those that are in ZIP files).  This would be a 2-step
  513.                    process:
  514.  
  515.                    First, delete the normal .BAK files
  516.  
  517.                       C:> SST *.bak -v -n
  518.  
  519.                              Supersonic Search Tool                   Page 10
  520.  
  521.  
  522.                              Command Line Switches                            
  523.  
  524.  
  525.  
  526.                    Then, delete them from the archive files
  527.  
  528.                       C:> SST -d -ao -zip *.bak -c"pkzip -d &f &m"
  529.  
  530.  
  531.      Switch:  -D
  532.     Meaning:  search all available hard drives.
  533. Description:  This switch tells SST to search every hard drive on your
  534.               system (including network drives), starting with C:.  In other
  535.               words, if you have drives C:, D:, E:, and F: then the following
  536.               two command lines would do the exact same thing:
  537.  
  538.                         SST cdef:myprog.exe
  539.                     or
  540.                         SST myprog.exe -d
  541.  
  542.               Note that specifying the "-d" switch overrides any drive
  543.               letters that you specify on the command line.
  544.  
  545.  
  546.      Switch:  -DIR
  547.     Meaning:  include directory names in the search.
  548. Description:  This switch tells SST to also include directory names in
  549.               the search.  This allows you to not only locate a lost file,
  550.               but lost directories, too.
  551.  
  552.  
  553.       Switch: -DUP
  554.      Meaning: Display only duplicate filenames on the drives searched.
  555.  Description: If the -DUP switch is specified, only those files that have
  556.               duplicate entries will be displayed.  All other switches are
  557.               active during -DUPlicate processing.  For example, the
  558.               following command line:
  559.  
  560.                       SST *.bat -a -d -dup
  561.  
  562.               would cause SST to search all hard drives (-d) looking for
  563.               duplicate .BAT files.  SST would also look inside of all
  564.               found Archive files (-a).
  565.  
  566.  
  567.      Switch:  -E
  568.     Meaning:  use "*.*" for subdirectory searches
  569. Description:  By default, SST assumes that you don't have any directories
  570.               on your hard drive that have extensions in the filename.  So,
  571.               when SST is looking for new directories, it will search with
  572.               a filemask of "*.".   This significantly speeds up the hard drive
  573.               search.  If you do have directories that have extensions in their
  574.               names, you must specify the '-e' switch or SST -will not-
  575.               find files within that subdirectory.  The easiest thing to do is
  576.               to set your SST environment variable to default to this
  577.  
  578.                              Supersonic Search Tool                   Page 11
  579.  
  580.  
  581.                              Command Line Switches                            
  582.  
  583.  
  584.               option (see "The SST Environment Variable" below).
  585.  
  586.  
  587.      Switch:  -F
  588.     Meaning:  display filenames only
  589. Description:  This switch causes SST to display only the filename of
  590.               matching files that it finds.  No header or footer information
  591.               will be displayed.  This is most useful when you are
  592.               redirecting the output from SST to a file.
  593.  
  594.  
  595.      Switch:  -G or -GF
  596.     Meaning:  go to the drive and subdirectory of the found file
  597. Description:  If you specify the '-g' switch, SST will prompt you with
  598.  
  599.                             Goto this subdirectory? (Y/N/Q) _
  600.  
  601.               whenever it finds a matching file.  Press 'Y' to change to
  602.               the drive and subdirectory displayed, or 'N' to continue
  603.               searching the drive.  You may also enter 'Q' to abort SST.
  604.               If you specify the '-gf' switch, SST will change to the
  605.               directory of the first found file without prompting you.
  606.  
  607.  
  608.      Switch:  -H or -HO
  609.     Meaning:  start searching in the current subdirectory
  610. Description:  The '-h' switch tells SST "start searching where I'm at
  611.               right now".   For example, if you are currently in the TURBOC
  612.               subdirectory, then the following two commands would do the
  613.               exact same thing:
  614.  
  615.                          SST \turboc\myprog.c
  616.                      or
  617.                          SST myprog.c -h
  618.  
  619.               The '-ho' switch tells SST to both (a) start in the current
  620.               directory, and (b) to ONLY search the current directory.
  621.               With this switch, SST can be used as a directory program
  622.               with the ability to list archive files.   For example,
  623.               you could create the following batch file and call it
  624.               ARCDIR.BAT:
  625.  
  626.                             @echo off
  627.                             SST %1 -ho -a
  628.  
  629.               Now, when you give the command "ARCDIR", you will be shown
  630.               the directory listing, along with all files contained within
  631.               archive files in your current subdirectory.
  632.  
  633.  
  634.      Switch:  -I
  635.     Meaning:  ignore the environment variable SST
  636.  
  637.                              Supersonic Search Tool                   Page 12
  638.  
  639.  
  640.                              Command Line Switches                            
  641.  
  642.  
  643. Description:  The '-i' switch tells SST to ignore any default switches
  644.               that you have set with the SST environment variable.  This
  645.               is most useful if you have page-breaking set up as a default,
  646.               but need to redirect SST's output to a file.  You could do
  647.               this with a command such as:
  648.  
  649.                            SST *.bat -i >files.dat
  650.  
  651.  
  652.      Switch:  -M -R -PL
  653.     Meaning:  modify SST's default output display
  654. Description:  These switches allow you to modify the way that SST
  655.               displays its output.  By default, SST will place the
  656.               filename on the left of the screen (just like DIR does).
  657.               If you prefer, you can use '-M' to place the filename in the
  658.               middle of the screen, '-R' to place the filename on the
  659.               right of the screen, or '-PL' to put the pathname on the left
  660.               of the screen.  Usually set in the environment.
  661.  
  662.  
  663.      Switch:  -K
  664.     Meaning:  search only the PATH directories
  665. Description:  This switch will cause SST to search only the directories
  666.               that are specified in your DOS PATH environment variable.
  667.               This option will be used very rarely, but was requested by a
  668.               user.
  669.        Note:  As of v4.1a, this switch was changed.  The '-K' switch was
  670.               previously the '-C' switch.
  671.  
  672.  
  673.      Switch:  -Y
  674.     Meaning:  display the output with European-style dates (DD-MM-YY)
  675. Description:  Again, a seldom-used switch, but requested by a user.
  676.  
  677.  
  678.      Switch:  -V [-N]
  679.     Meaning:  do a verified delete of any matching files found
  680. Description:  These switches tell SST to delete any matching files found.
  681.               If you specify only the '-V' switch, then SST will prompt
  682.               you before it deletes each file.  If you specify BOTH the '-V'
  683.               and the '-N' switch, then SST --WILL NOT-- prompt you; it
  684.               will just go ahead and delete the file (PLEASE be careful with
  685.               this one!).  I use these switches daily to clean up all of the
  686.               .BAK files created by Turbo C.  For example:
  687.  
  688.                           SST *.bak -v -n
  689.  
  690.  
  691.      Switch:  -W
  692.     Meaning:  show wasted space occupied by matching files.
  693. Description:  This switch is used very little, but can come in handy if you
  694.               are trying to figure out how much disk space is being wasted
  695.  
  696.                              Supersonic Search Tool                   Page 13
  697.  
  698.  
  699.                              Command Line Switches                            
  700.  
  701.  
  702.               by a bunch of very small files (batch files are a prime
  703.               example).  SST will total and display to you the amount of
  704.               disk space that is being wasted due to cluster overhead.
  705.  
  706.  
  707.      Switch:  -U
  708.     Meaning:  display all output in upper case
  709. Description:  Some people still prefer to see directory-type listings in
  710.               ALL UPPER CASE; if you're one of these people, then just use
  711.               the '-U' switch.  It's best to set this in your SST
  712.               environment variable.
  713.  
  714.  
  715.      Switch:  -P
  716.     Meaning:  pause and wait for a key when the screen fills up
  717. Description:  A very handy switch, best used when set in your environment
  718.               variable.   It will cause SST to pause the screen when it
  719.               fills up, so you don't have to go crazy trying to hit the
  720.               control-S key.
  721.  
  722.  
  723.      Switch:  -PKLite
  724.     Meaning:  search for files compressed with PKLite
  725. Description:  This switch will cause SST to only look for .COM and
  726.               .EXE files that have been compressed with PK-Ware's PKLITE
  727.               program.  PKLite is a program that compresses executable
  728.               programs, and then un-compresses them at runtime.
  729.  
  730.  
  731.      Switch:  -Xfilemask
  732.     Meaning:  exclude this filespec from the search
  733. Description:  The '-X' switch allows you to exclude certain filenames from
  734.               the directory search.  You can specify up to 25 exclusion
  735.               masks.   For example, if you wanted to see all files on your
  736.               drive except for .OBJ and .PRG files, you could do:
  737.  
  738.                         SST *.* -x*.obj -x*.prg
  739.  
  740.  
  741.      Switch:  -LT -EQ -GT
  742.     Meaning:  specify a file size range
  743. Description:  These switches allow you to search only for files within a
  744.               certain size range.  Some examples:
  745.  
  746.                          SST *.PAS -LT1024
  747.  
  748.               would display all .PAS files that have a size smaller than
  749.               1024 bytes.
  750.  
  751.                          SST *.* -EQ0
  752.  
  753.               would display all files that have a length of zero.
  754.  
  755.                              Supersonic Search Tool                   Page 14
  756.  
  757.  
  758.                              Command Line Switches                            
  759.  
  760.  
  761.  
  762.                          SST *.* -GT500000
  763.  
  764.               would display all files that are larger than 500,000 bytes.
  765.  
  766.                          SST *.* -GT1023 -LT2049
  767.  
  768.               would display all files that are from 1,024 to 2,048
  769.               bytes in size, inclusive.
  770.  
  771.  
  772.      Switch:  -S -B
  773.     Meaning:  specify a file date range
  774. Description:  These switches allow you to search only for files within a
  775.               certain date range.  These switches are the "since" (S)
  776.               switch and the "before" (B) switch.  Both switches come in
  777.               two flavors; you can specify the date in number of days
  778.               (eg: -S5) or with a full date (eg: -S8-19-89).   If you
  779.               specify either switch with no date specifier, then it defaults
  780.               to '0 days'.  These date specifiers are also used when looking
  781.               inside of archive files.  Some examples:
  782.  
  783.                           SST *.PAS -S5
  784.  
  785.               would display all .PAS files that have a date greater than or
  786.               equal to 5 days ago (in other words, modified SINCE 5 days ago).
  787.  
  788.                           SST *.PAS -S5-1-89
  789.  
  790.               would display all .PAS files modified SINCE  5/1/89.
  791.  
  792.                           SST *.PAS -B5
  793.  
  794.               would display all .PAS files modified BEFORE 5 days ago.
  795.  
  796.                           SST *.PAS -B5-1-89
  797.  
  798.               would display all .PAS files modified BEFORE 5/1/89.
  799.  
  800.                           SST *.PAS -S5-1-89 -B6-1-89
  801.  
  802.               would display all .PAS files modified between the dates of
  803.               5-1-89 and 5-31-89.
  804.  
  805.                           SST *.PAS -S
  806.  
  807.               would display all .PAS files that have been modified today
  808.               (defaults to '-S0').
  809.  
  810.  
  811.      Switch:  -Z
  812.     Meaning:  show only files with their archive bit set
  813.  
  814.                              Supersonic Search Tool                   Page 15
  815.  
  816.  
  817.                              Command Line Switches                            
  818.  
  819.  
  820. Description:  The '-Z' switch allows you to display only those files which
  821.               have their "archive bit" set on.  In other words, it will show
  822.               all files that have been modified since your last backup (if
  823.               your backup program clears the archive bit, that is).
  824.  
  825.  
  826.      Switch:  -HIDDEN
  827.     Meaning:  also show hidden and system files
  828. Description:  The '-hidden' switch allows you to also display those files
  829.               which are "system" and "hidden" files.
  830.  
  831.                              Supersonic Search Tool                   Page 16
  832.  
  833.  
  834.                   The SST and SST_DRIVES Environment Variables                
  835.  
  836.  
  837.  
  838.     When SST begins execution, it searches the environment for a variable
  839. named SST.   If this variable is present, its contents will be appended
  840. onto the command line just as if you had entered them in from the keyboard.
  841. This option is very handy for setting "default options" that you'd like for
  842. SST to perform every time.   Simply set the SST variable in your
  843. AUTOEXEC.BAT file.   For example, if you'd like to always (a) page break
  844. when the screen fills up, (b) display the filenames on the right of the
  845. screen, and (c) display output in upper case, you would put the following in
  846. your AUTOEXEC.BAT file:
  847.  
  848.                     SET SST=-P -R -U
  849.  
  850.  
  851.     SST would then use these options every time you executed the program.
  852.  
  853.  
  854.    If you specify the "-d" switch (search all drives), then SST will
  855.  search the environment looking for a variable named SST_DRIVES.   If this
  856.  variable is found, SST will use this list as the definition of the
  857.  drives to search.  If the SST_DRIVES variable does not exist, SST will
  858.  use its own list, which defaults to drives c: through z: (ie: cde...z).
  859.  
  860.    The SST_DRIVES variable was added mainly for those people using networks.
  861.  SST's reckless abandon of simply searching all drive letters caused
  862.  some network users a lot of headaches.   It seems that those affected the
  863.  most were users of Novell networks.   On Novell, you can specify many
  864.  different drive letters for the same "volume" (ie: partition), so SST
  865.  would show the same physical file many times, since SST thought that
  866.  it was really on a different drive.   With the SST_DRIVES variable, it is
  867.  up to the user to tell SST what drives are physically different.  For
  868.  example, let's assume that you have 3 volumes defined, and the drive letter
  869.  assignments are as follows:
  870.  
  871.                  Volume 1  -     drives C: and D:
  872.                  Volume 2  -     drives E: and F:
  873.                  Volume 3  -     drives G: and H:
  874.  
  875.    For SST to work correctly, you would put the following line in your
  876.  AUTOEXEC.BAT file:
  877.  
  878.                     Set SST_DRIVES=CEG
  879.  
  880.    Now, when you search using the "-d" switch, SST won't list duplicate
  881.  filenames.  I have never used a Novell network, so I'm hoping that this
  882.  change will eliminate the problems.   This problem was brought up to me in
  883.  a letter from Bud Huddleston of Chamblee, GA.   Luckily, he went into great
  884.  detail on what the problem was.  The SST_DRIVES variable was the easiest
  885.  way I could think of to attack this problem.   If this isn't the best way
  886.  to handle the situation, I'd appreciate it if you Novell users would drop
  887.  me a line with suggestions.  Note that the search for the SST_DRIVES variable
  888.  CAN NOT be over-ridden from the command line.  If the SST_DRIVES variable
  889.  
  890.                              Supersonic Search Tool                   Page 17
  891.  
  892.  
  893.                   The SST and SST_DRIVES Environment Variables                
  894.  
  895.  
  896.  exists, it is used every time.  If you need to search a different list,
  897.  you must specify a drive list with the filename instead of using the "-d"
  898.  switch.  For example, "SST cdfg:*.bat".
  899.  
  900.    For those users who are not on a network, you don't need to do anything
  901.  differently from version 3.5 of SST.   If the SST_DRIVES variable isn't
  902.  defined, then v3.6 will perform exactly as v3.5 did.
  903.  
  904.  
  905.                              Supersonic Search Tool                   Page 18
  906.  
  907.  
  908.                           Duplicate Filename Searching                        
  909.  
  910.  
  911.  
  912.     V4.0 of SST incorporates a feature that I've been wanting for a very
  913.   long time - the ability to search all drives, including Archive files, and
  914.   display only those files that are duplicated somewhere else.   This was a
  915.   fairly major upgrade to do, but it turned out (in my opinion) to be the best
  916.   added feature to SST yet.
  917.  
  918.     Maybe I'm worse than other people at this, but I'm terrible about doing a
  919.   download of a file, un-Arcing it, and then starting to use it.  Of course,
  920.   the original of that file is still sitting out there somewhere in an Archive
  921.   file just eating up hard disk space.
  922.  
  923.     With the new -DUP feature, cleaning up your multiple hard drives from any
  924.   duplicate files is much easier.  But, be aware that when you invoke the -DUP
  925.   switch, SST gets VERY memory-hungry.  This is because SST must keep
  926.   information on every filename on all of your hard drives (including all of
  927.   those filenames in any Archive files) in memory AT ONE TIME.
  928.  
  929.     If you ever get the message "Error: out of memory!" when trying to find
  930.   duplicates across all drives, there are a couple of things that you can do.
  931.   First of all, see if you can free up any more memory by removing any TSR's
  932.   or device drivers.  If you still get the "out of memory" message, then there
  933.   are two different things that you can do.   The first is that you could
  934.   compare the drives two (or three) at a time.  For example, if you
  935.   have drives C:, D:, E:, and F:, first compare drives C: and D:, then C: and
  936.   E:, etc. until you've scanned them all.
  937.  
  938.     The second thing you can do (the way I prefer) is to do the duplicate scan
  939.   with a filemask; in other words, do the scan on *.EXE, then *.COM, then
  940.   *.BAT, etc.   For example, here's a sample of what you'd do:
  941.  
  942.               C:> SST *.com -d -a -dup
  943.  
  944.               C:> SST *.bat -d -a -dup
  945.  
  946.               C:> SST *.exe -d -a -dup
  947.  
  948.     I don't see the "out of memory" being a problem except for those people
  949.   with HUGE hard drives.  I have two 40-meg drives, both packed full of ZIP
  950.   files, and I never got close to filling up memory.   In addition, SST
  951.   is fairly intelligent when saving the names in memory; for example, if
  952.   you have 300 files in the path C:\TEST1\TEMP\DATA, the actual pathname
  953.   will only get saved one time.  If you are looking for duplicates on a very
  954.   big hard drive system (let's say 80 meg or more), then SST will take some
  955.   time.   Don't be alarmed if the program seems to not be doing anything;
  956.   searching the file tables of very large hard drives takes some time.  I
  957.   tinkered with the idea of putting in a twirling cursor or something so that
  958.   you'd know SST was still alive, but I decided against it.  Since
  959.   duplicate searching will probably be redirected to a printer or a disk file
  960.   most of the time, I didn't want to trash up the display.
  961.  
  962.  
  963.  
  964.                              Supersonic Search Tool                   Page 19
  965.  
  966.  
  967.                           Duplicate Filename Searching                        
  968.  
  969.  
  970.     Don't forget that the -DUP switch works in tandem with ALL other SST
  971.   switches.   For example, specifying -DUP doesn't automatically scan all hard
  972.   drives and look inside all Archive files.  You must still specify the -A and
  973.   -D switches.    Also, filename exclusions still work just like normal.
  974.   Let's do a few examples:
  975.  
  976.  
  977.       C:> SST -d -a -dup
  978.  
  979.                    This is the command you'll normally want to do when
  980.                    searching for duplicates.  It causes SST to search
  981.                    all hard drives, and inside Archive files, looking for
  982.                    duplicates.
  983.  
  984.  
  985.       C:> SST *.bat -d -a -dup
  986.  
  987.                    This command would only list the duplicate .BAT files
  988.                    on your hard drives.
  989.  
  990.       C:> SST cd:*.* -a -dup -x*.bak -x*.doc
  991.  
  992.                    This command would display all duplicate files on drives
  993.                    C: and D: except any .BAK or .DOC files.
  994.  
  995.                              Supersonic Search Tool                   Page 20
  996.  
  997.  
  998.                        Keith Ledbetter's Software Catalog                     
  999.  
  1000.  
  1001.  
  1002. Keith Ledbetter's Software Catalog
  1003. ----------------------------------
  1004.  
  1005.     Listed below is a chart of my other shareware and freeware utilities,
  1006. along with the current version number of each.  Also listed is the
  1007. filename that you will find them under on BBS systems (please note that
  1008. they may be different on your favorite BBS's, but it should help you at
  1009. least get close to locating them).   When you register one of my Shareware
  1010. programs, you will receive a disk with all of these utilities on it.
  1011.  
  1012.  
  1013.    Filename      Version            Description
  1014.   -----------    -------     -------------------------------
  1015.   SST_53a.ZIP      5.3a      The ultimate file-finder program.  Until
  1016.                              recently this was simply called "WhereIs".
  1017.                              It's now been renamed to "Supersonic Search
  1018.                              Tool" to avoid confusion with other programs.
  1019.                              Shareware: $15
  1020.  
  1021.   LCD_31a.ZIP      2.1a      "Led's Change Directory" is an intelligent
  1022.                              directory changing program.  This program was
  1023.                              voted one of "the 10 best utilities of 1990"
  1024.                              by the "Public (software) Library" magazine.
  1025.                              Shareware: $15
  1026.  
  1027.   AV_12.ZIP        1.2       "Archive Viewer" is used to display the names
  1028.                              of members of all of the popular archiving
  1029.                              programs (ZIP, ARC, LHARC, PKARC, ZOO, PAK).
  1030.                              No longer do you have to struggle remembering
  1031.                              the syntax to 6 different archiving programs.
  1032.                              Freeware: $0
  1033.  
  1034.   X_30.ZIP         3.0       "X: The Executioner" can save you a lot of
  1035.                              disk space.  X allows you to ZIP down those
  1036.                              seldom-used-but-hard-to-delete .COM, .EXE,
  1037.                              and .BAT files into one system "Command
  1038.                              Library".  You can then execute them easily
  1039.                              by simply typing an "x" in front of the
  1040.                              command line (eg: "x chkdsk c:").
  1041.                              Freeware: $0
  1042.  
  1043.   ADMENU30.ZIP     3.0       If you own an Adlib Music card, you need this
  1044.                              program.  It allows you to ZIP down all of
  1045.                              those .ROL song files you've accumulated, yet
  1046.                              still play them with no extra effort!  Uses
  1047.                              a mouse-able, easy-on-the-eyes window system.
  1048.                              Freeware: $0
  1049.  
  1050.   DELDIR12.ZIP     1.2       "Delete Directory" allows you to delete an
  1051.                              entire directory (and all directories under
  1052.                              it) with one quick command.  You will be
  1053.  
  1054.                              Supersonic Search Tool                   Page 21
  1055.  
  1056.  
  1057.                        Keith Ledbetter's Software Catalog                     
  1058.  
  1059.  
  1060.                              shown totals of what you are about to delete
  1061.                              and then be asked to confirm (the confirm
  1062.                              process can be over-ridden from the command
  1063.                              line).
  1064.                              Freeware: $0
  1065.  
  1066.   DIRSIZ11.ZIP     1.1       "Directory Size Information" allows you to
  1067.                              easily determine the total size (in both
  1068.                              files and bytes) of any directory.
  1069.                              Freeware: $0
  1070.  
  1071.   DUPICO10.ZIP     1.0       "Duplicate Icon Deleter" is for any Windows
  1072.                              3.0 user who has accumulated tons of icons.
  1073.                              It will go through a directory and delete all
  1074.                              duplicate icon images, regardless of what they
  1075.                              are named.
  1076.                              Freeware: $0
  1077.  
  1078.   TIMER10.ZIP      1.0       This program allows you to easily time the
  1079.                              execution of any program.  Simply use TIMER
  1080.                              to invoke the command (eg: "timer chkdsk C:")
  1081.                              and you will be shown, at the completion of
  1082.                              the command, the elapsed time.
  1083.                              Freeware: $0
  1084.  
  1085.   UNTAB10.ZIP      1.0       One of the fastest "un-tab" programs you will
  1086.                              find.  It takes the specified input file and
  1087.                              copies it to the specified output file,
  1088.                              replacing all tab characters with hard blanks
  1089.                              (you specify the "tab size").
  1090.                              Freeware: $0
  1091.  
  1092.  
  1093.   You can download all of these files from the Blue Ridge Express in
  1094. Richmond, VA.   This is the official tech support board for all of my
  1095. software, and there's a special "Keith Ledbetter" message section where
  1096. you can quickly get your questions answered.   Once you log on, just do
  1097. a "J KEITHL" to join my sub-board.  First-time callers have access to
  1098. both my message base and all of my download files.
  1099.  
  1100.   The Blue Ridge Express is a first-class BBS, with 30 phone lines; no
  1101. need to worry about getting a busy signal!  The number is:
  1102.  
  1103.  
  1104.                         The Blue Ridge Express BBS
  1105.                                804-790-1675
  1106.  
  1107.  
  1108.                              Supersonic Search Tool                   Page 22
  1109.  
  1110.  
  1111.                        Keith Ledbetter's Software Catalog                     
  1112.  
  1113.  
  1114.   All of my software can also be obtained from the following places:
  1115.  
  1116.  
  1117.       Alternative Personal Software
  1118.       269 Springside Drive  Suite C
  1119.       Hamilton, Ontario
  1120.       Canada  L9B 1P8
  1121.       Tel: (416) 577-4068
  1122.  
  1123.       PC Assist Limited
  1124.       4 Carruber's Close
  1125.       135 High Street
  1126.       Edinburgh,  EH1 1SJ
  1127.       Scotland
  1128.       Tel: 031-557-6432
  1129.  
  1130.       BroCo Software
  1131.       P. O. Box 446
  1132.       3760 AK  SOEST
  1133.       Holland
  1134.       Tel: 31-2155-26650
  1135.  
  1136.       EURO BOARD
  1137.       John Warren
  1138.       Postfach
  1139.       3920 ZERMATT, VS
  1140.       Switzerland
  1141.       BBS:  (0228) / 476-111-06 (Swiss Telepac)
  1142.  
  1143. End of document.
  1144.